home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / nt / embh_n.zip / EMBH.TXT < prev    next >
Text File  |  1993-02-19  |  4KB  |  85 lines
  1. *****************************************************************************
  2. *                                                                           *
  3. *              EMBH: Embedded windows for Windows Help projects.            *
  4. *                             Windows NT Version                            *
  5. *                          2/18/93  by  Mark Gamber                         *
  6. *                                                                           *
  7. *****************************************************************************
  8.  
  9. >   EMBH is a library of animated windows that may be embedded anywhere in a
  10. Windows help file at any time. To begin using EMBH, copy EMBH.DLL and
  11. EMBH.HLP to your Windows or work directory. As long as Windows or the path
  12. can find it, you're Ok. Before you start, I recommend you run WinHelp and
  13. view TEST.HLP included with this file to see how things work.
  14.  
  15. >   This text file makes no attempt to describe standard WinHelp features,
  16. such as linking hotspots to macros and so on. Only the EMBH library and how
  17. it interfaces with WinHelp is described.
  18.  
  19. >   EMBH provides four window types. BULLETs are small circles with a black
  20. border and colored interior. ARROWs are small arrows with stems, a black
  21. border and colored interior. These two types may be set to remain a static
  22. luminence, cycle forward or cycle backward. A MODEM is the easiest as it
  23. uses no parameters but just blinks a couple lights. POINTERs are the most
  24. powerful as their colors may be set by calling an EMBH macro from WinHelp.
  25.  
  26. >   BULLETS and ARROWs take the same parameters from WinHelp and do the same
  27. thing, excepting their shapes. To add a BULLET or ARROW to your WinHelp file,
  28. you simply add {ewl EMBH.DLL,BULLET,DRGB} or {ewl EMBH.DLL,ARROW,DRGB} to
  29. your text, depending on the type used. The last parameter, "DRGB", describes
  30. the direction to cycle and RGB colors to use.
  31.     D:    "F" for forwards, "B" for backwards, "A" for static.
  32.     R: "1" to include RED, "0" to omit it.
  33.     G: "1" to include GREEN, "0" to omit it.
  34.     B: "1" to include BLUE, "0" to omit it.
  35. Look at TEST.HLP using WinHelp to see real examples as they work.
  36.  
  37. >    MODEM takes no parameters and is a snap to drop in. Just add:
  38.     {ewl EMBH.DLL,MODEM,0}
  39. to your text to display a blinking modem from WinHelp
  40.  
  41. >   POINTERs are special as their colors may be changed under macro control.
  42. Initially, they have a name and color specified using this syntax:
  43.  
  44.     {ewl EMBH.DLL,POINTER,Name:RGB}
  45.  
  46.     Name:    Any alphanumeric name up to 30 characters long.
  47.     -Colon separator -
  48.     R:        "1" to include RED, "0" to omit it.
  49.     G:        "1" to include GREEN, "0" to omit it.
  50.     B:        "1" to include BLUE, "0" to omit it.
  51.  
  52. All POINTERs on the same page must have unique Names if they are to work
  53. correctly. Names like "Pointer1", "Pointer2" and so on are fine. In addition
  54. to the pointer itself, EMBH provides a macro you can call from WinHelp to
  55. change the color of a pointer "on the fly". The macro must be added to the
  56. help project file [CONFIG] section as follows:
  57.  
  58. RegisterRoutine("EMBH.DLL","SetRightPointerColor","SSS")
  59.  
  60. Now the routine may be called from within WinHelp. As seen above, the macro
  61. takes three parameters. The First string is the title of the WinHelp main
  62. window, the default being "Windows Help". Second is the Name of the pointer
  63. to change as specified by the Name field of the {ewl} entry. Third is the
  64. RGB bits to change. For example:
  65.  
  66. SetRightPointerColor("Windows Help","Pointer1","100")
  67.  
  68. Sets the color of pointer "Pointer1" to Red.
  69.  
  70. *****************************************************************************
  71.  
  72. >    EMBH is not public domain, but may be freely distributed and included in
  73. any projects without royalty. In using EMBH, the user accepts responsibility
  74. for proper use and shall hold harmless EMBH and it's author from any damages
  75. whether real or imagined. EMBH may NOT be altered in ANY WAY without approval
  76. of the author.
  77.  
  78. *****************************************************************************
  79.  
  80. >    The author may be reached via the following services:
  81.  
  82.     America Online E-Mail:    PCA MarkG
  83.     Compuserve Mail:            76450,2754
  84.     Internet Mail:                pcamarkg@aol.com
  85.